home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ForCLI / where154.lzh / where154g.doc < prev    next >
Text File  |  1993-05-01  |  9KB  |  220 lines
  1. May 1993
  2. *************************************************************************
  3. *                                                                       *
  4. *                       Where  Version 1.54g                            *
  5. *                                                                       *
  6. *       Copyright 1989, 1990, 1991, 1992, 1993 by John Preston          *
  7. *                                                                       *
  8. *************************************************************************
  9.  
  10.  
  11. Chagnes from 1.53 are mainly for Where Gold, but this version also
  12. includes the -t flag to force where not to take a subdir brach.  This
  13. can be useful if you wish to use the -x option to execute a command
  14. that does not support wildcards, like C:Protect, but you only want to
  15. execute the command on files in the current dir and not all the 
  16. sub directories.
  17.  
  18. Also this version of where includes the beta version of WhereGold.  While
  19. there is still a lot of things to do to WhereGold, I thought you folks 
  20. would what to take a look at how things were coming along on the project.
  21.  
  22. You do not need WhereGold to run where, but Where is MANDATORY to run where
  23. gold.
  24.  
  25. This version is 1.3 and 2.0 compatable.  Fortunatly there was not many
  26. changes to be made to make it compatable with 2.0.  Actually the older 
  27. version works under 2.0, but I changed some things I though may be less
  28. portable just to be safe.
  29.  
  30. Some of the bugs not fixed are the slight loss of RAM due to recursive
  31. tree building.
  32.  
  33. You may also find this program on some of the software disks with the
  34. KRONOS hard drive contrller by MicroDyn.
  35.  
  36.   Thankyou,  John Preston
  37.  
  38.                     *------------------------------*
  39. HISTORY:
  40.      This program was a part of a larger hard disk backup program I was 
  41. working on.  I wrote Where as a way for the backup program to be able to
  42. find the directories and files on the entire hard drive.  Accidentally, I
  43. noticed how easy it would be to add a compare routine to display certain
  44. files of interest.
  45.                          Thus Where was born!
  46.                        ***********************
  47.  
  48.      After some preliminary testing, I enhanced Where to accept rudimentary
  49. wildcards in the filename field.  Later I improved the wildcard handling
  50. to include both support for AmigaDOS wildcards and UNIX/MSDOS style 
  51. wildcards (Thanks Lattice for C 5.0!). On this version the last improvement
  52. was to display the directory being searched, and if no files were found to
  53. redraw the next directory to be searched on top of the old display.  This
  54. is a nice feature and was suggested by Eric Calcagni.  (i.e. You are not 
  55. left in awe at the hard drive light flashing madly at you while nothing 
  56. appears to be happening. Where shows you when it moves from one directory
  57. to another!)
  58.  
  59. *************************************************************************
  60. *                                                                       *
  61. *      W h e r e  i s  a c c e p t e d  b y  t h e  p u b l i c         *
  62. *                                                                       *
  63. *************************************************************************
  64.  
  65.      Now that Where has been in limited use by a few of my friends, some
  66. enhancements have been added or suggested.  One of these suggestions is 
  67. in this version.  I want to thank Andre Frech of Commodore and Eric Calcagni
  68. of Computer Bar in Pensacola FL for their suggestions.
  69.  
  70.      1) Where will now give a complete listing of files it finds including
  71.         file attribute flags, s-p-h-a-r-w-e-d (see AmigaDOS Protect 
  72.         Command), date, time, blocks, bytes and filename.  This is the -l 
  73.         or list option.
  74.  
  75.      2) All option flags now are preceeded with a dash and parameters can
  76.         appear in any order.  A bad flag brings up a HELP menu.
  77.  
  78.         so,
  79.  
  80.         Where DH0:#? -l
  81.  
  82.         is the same as 
  83.  
  84.         Where -l DH0:#?
  85.  
  86. NOTE: The flags -c and -r are only partially implemented and should not be 
  87. used in this release.
  88.  
  89.                          ************************
  90.                          * Intricacies of Where *
  91.                          ************************
  92.  
  93. Here are some example CLI entries:
  94.  
  95.   ----------------------------------------------------------------------------
  96.    This will search the current drive/directory and all subdirectories
  97.    associated with that drive/directory.
  98.  
  99.     1> Where myfile
  100.  
  101.   ----------------------------------------------------------------------------
  102.    This will search all directories on the hard drive DH0: for all files 
  103.    ending in .pic
  104.  
  105.     1> Where DH0:#?.pic
  106.  
  107.   ----------------------------------------------------------------------------
  108.    This will search all the directories in the directory df0:devs for all
  109.    files beginning with printer
  110.  
  111.     1> Where DF0:devs/printer#?
  112.  
  113.   ----------------------------------------------------------------------------
  114.    This will search all the directories in the current directory and all
  115.    of its subdirectories for any file
  116.  
  117.     1> Where #?
  118.  
  119.   ----------------------------------------------------------------------------
  120.    This will search DH0: for all files ending in .c and pause until ENTER 
  121.    or RETURN is pressed
  122.  
  123.     1> Where DH0:#?.c -p
  124.  
  125.   ----------------------------------------------------------------------------
  126.    This will search directories devs: and rad:devs for all files ending in
  127.    .device  and give a long listing of the file's info.
  128.  
  129.         1> Where devs:#?.device  rad:#?.device -l
  130.  
  131.   ----------------------------------------------------------------------------
  132.    This will search DH0: for the file PAINT_PROG and then search DH1: for
  133.    the files MyPics#? It will pause on each hit and give a long listing.
  134.  
  135.          1> Where DH0:PAINT_PROG DH1:MyPics#? -p -l
  136.  
  137.   ----------------------------------------------------------------------------
  138.    To abort the program while it is running type CTRL-C.
  139.  
  140.   ----------------------------------------------------------------------------
  141.    To execute a command on a file that Where has found enter the following
  142.  
  143.          1> Where Dh0:*.pic -x "Showprog %s"
  144.  
  145.    In this example we wish to show all IFF pics with filenames ending in
  146.    .pic and we want to use our favorite show program 'showprog'.  Notice
  147.    the %s is where the ENTIRE PATH AND FILENAME will be inserted in the
  148.    command string to be passed to our showprog.  This version uses the
  149.    AmigaDOS function Execute() therefore the RUN AmigaDOS command MUST be
  150.    in the C: directory!
  151.  
  152.   ----------------------------------------------------------------------------
  153.    This will search DH0: for the file PAINT_PROG and then search DH1: for
  154.    the files MyPics#? It will only search the current directories therefore
  155.    it will not go into any of the subdirectories on DH0: or DH1:
  156.  
  157.          1> Where DH0:PAINT_PROG DH1:MyPics#? -t
  158.  
  159.   ----------------------------------------------------------------------------
  160.    This will search DH0: for the file PAINT_PROG and then search DH1: for
  161.    the files MyPics#? It will only search the current directories therefore
  162.    it will not go into any of the subdirectories on DH0: or DH1:.  If any
  163.    files are found it will then run multiview on them.
  164.  
  165.          1> Where DH0:PAINT_PROG DH1:MyPics#? -t -x "Multiview %s"
  166.  
  167.  
  168.                               DISCLAIMERS:
  169.                             ***************
  170.  
  171.      As of this version there is one known bug in Where.  When you break
  172. the program with CTRL-C RETURN not all of the memory used by Where is 
  173. returned to the system.  I hope to have this bug fixed soon but thought I'd
  174. release this EXCELLENT PROGRAM to the Amiga public RIGHT AWAY!  I have not
  175. found any other problems but Where has not been through the ACID TEST yet.
  176. I am sure under low memory conditions Where will balk, but that is for 
  177. later.
  178.  
  179. Also the flags -c and -r are only partially implemented and should not be 
  180. used in this release.
  181.  
  182.                             COPYRIGHT NOTICE!
  183.                          ***********************
  184.  
  185.      This program has a 1989 Copyright under the name John Brock Preston
  186. and is not for commercial use without written consent from the author/holder
  187. of the copyright.  A written conscent can be obtained by submitting $25.00US
  188. to the following address (Which may also allow you to get the latest updates
  189. as well as other goodies!).
  190.  
  191.      John Preston
  192.      508 E. Warren St.
  193.      Mt Pleasant, IA 52641
  194.  
  195.      If you have any questions or suggestions please send mail and I will 
  196. try to answer them.
  197.  
  198.  
  199. Thanks for your patronage,
  200.  
  201.  
  202.    John Preston, a starving Amiga programmer.
  203.  
  204. CEO Preston Enterprises
  205.  
  206. A Member of The HST Group.
  207.  
  208.  
  209.  * Amiga and AmigaDOS are trademarks of Commodore Business Machines.
  210.  * Lattice C 5.0, 6.0 is a product of Lattice Incorporated.
  211.  * UNIX is a product of AT&T
  212.  * All legal rights to Where are reserved by the original author and 
  213.    unauthorized use of Where or this manual or the Where Icon without
  214.    written consent from the original author is prohibited.
  215.  
  216. Only Amiga Makes it Possible!
  217.  
  218. FIDONET: Call Amiga Depot (319)385-8424
  219. Where is FREQable as the name WHERE154.LZH
  220.